package com.smart.community.property.mapper;

import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.property.entity.SanitationFee;

/**
 * 卫生费Mapper接口
 * 
 * @author Wu.Liang
 * @since 2024-12-21
 * @version 2.0.0
 */
@Mapper
public interface SanitationFeeMapper extends BaseMapper<SanitationFee> {
    
    /**
     * 分页查询卫生费账单
     * 
     * @param page 分页参数
     * @param communityId 社区ID（单个）
     * @param communityIds 社区ID列表（数据权限过滤）
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期）
     * @param billingPeriod 计费周期
     * @param buildingId 楼栋ID
     * @param unitId 单元ID
     * @param householdId 房户ID
     * @return 分页结果
     */
    IPage<SanitationFee> selectSanitationFeePage(Page<SanitationFee> page,
                                                @Param("communityId") Long communityId,
                                                @Param("communityIds") List<Long> communityIds,
                                                @Param("paymentStatus") Integer paymentStatus,
                                                @Param("billingPeriod") String billingPeriod,
                                                @Param("buildingId") Long buildingId,
                                                @Param("unitId") Long unitId,
                                                @Param("householdId") Long householdId);
    
    /**
     * 根据用户ID查询未缴费卫生费账单
     * 
     * @param userId 用户ID
     * @return 未缴费账单列表
     */
    List<SanitationFee> selectUnpaidSanitationFeesByUserId(@Param("userId") Long userId);
    
    /**
     * 更新卫生费支付状态
     * 
     * @param id 账单ID
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期）
     * @param paymentAmount 支付金额
     * @param paymentTime 支付时间
     * @return 更新结果
     */
    int updatePaymentStatus(@Param("id") Long id,
                           @Param("paymentStatus") Integer paymentStatus,
                           @Param("paymentAmount") BigDecimal paymentAmount,
                           @Param("paymentTime") LocalDateTime paymentTime);
    
    /**
     * 查询需要生成卫生费账单的房户信息
     * 
     * @param communityId 社区ID
     * @param billingPeriod 计费周期
     * @return 房户信息列表
     */
    List<Map<String, Object>> selectHouseholdsForSanitationFee(@Param("communityId") Long communityId,
                                                               @Param("billingPeriod") String billingPeriod);
    
    /**
     * 查询逾期卫生费账单
     * 
     * @param communityId 社区ID
     * @param dueDate 到期日期
     * @return 逾期账单列表
     */
    List<SanitationFee> selectOverdueSanitationFees(@Param("communityId") Long communityId,
                                                    @Param("dueDate") LocalDate dueDate);
    
    /**
     * 获取卫生费统计信息
     * 
     * @param communityId 社区ID
     * @param year 年份
     * @return 统计信息
     */
    Map<String, Object> selectSanitationFeeStatistics(@Param("communityId") Long communityId,
                                                      @Param("year") Integer year);
    
    /**
     * 批量生成卫生费账单（按时间段生成一份总费用单）
     * 
     * @param communityId 社区ID
     * @param billingPeriod 计费周期（时间段格式：2025-08 ~ 2025-11）
     * @param perPersonFee 人均费用
     * @param createBy 创建人ID
     * @param dueDate 到期日期
     * @param monthCount 月份数量
     * @param remark 备注
     * @return 生成的账单数量
     */
    int batchGenerateSanitationFeesByRange(@Param("communityId") Long communityId,
                                          @Param("billingPeriod") String billingPeriod,
                                          @Param("perPersonFee") BigDecimal perPersonFee,
                                          @Param("createBy") Long createBy,
                                          @Param("dueDate") LocalDate dueDate,
                                          @Param("monthCount") Integer monthCount,
                                          @Param("remark") String remark);
    
    /**
     * 查询需要生成卫生费账单的房户信息（按时间段）
     * 
     * @param communityId 社区ID
     * @param billingPeriod 计费周期
     * @param feeType 费用计费方式：0-按面积计费，1-固定费用
     * @return 房户信息列表
     */
    List<com.smart.community.property.dto.SanitationFeeHouseholdDTO> selectHouseholdsForSanitationFeeByRange(@Param("communityId") Long communityId,
                                                                                                             @Param("billingPeriod") String billingPeriod,
                                                                                                             @Param("feeType") Integer feeType);
    
    /**
     * 插入单条卫生费账单
     * 
     * @param sanitationFee 卫生费账单对象
     * @return 插入结果
     */
    int insertSanitationFee(SanitationFee sanitationFee);
    
    /**
     * 批量插入卫生费账单
     * 
     * @param feeList 卫生费账单列表
     * @return 插入数量
     */
    int batchInsertSanitationFees(@Param("feeList") List<SanitationFee> feeList);
} 